home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / vbdatabs / stack.h < prev    next >
C/C++ Source or Header  |  1999-03-14  |  5KB  |  153 lines
  1. // ------------------------------- //
  2. // -------- Start of File -------- //
  3. // ------------------------------- //
  4. // ----------------------------------------------------------- //
  5. // C++ Header File Name: stack.h 
  6. // Compiler Used: MSVC40, DJGPP 2.7.2.1, GCC 2.7.2.1, HP CPP 10.24
  7. // Produced By: Doug Gaer   
  8. // File Creation Date: 01/21/1997 
  9. // Date Last Modified: 03/15/1999
  10. // Copyright (c) 1997 Douglas M. Gaer
  11. // ----------------------------------------------------------- // 
  12. // ---------- Include File Description and Details  ---------- // 
  13. // ----------------------------------------------------------- // 
  14. /*
  15. The VBD C++ classes are copyright (c) 1997, by Douglas M. Gaer.
  16. All those who put this code or its derivatives in a commercial
  17. product MUST mention this copyright in their documentation for
  18. users of the products in which this code or its derivative
  19. classes are used. Otherwise, you have the freedom to redistribute
  20. verbatim copies of this source code, adapt it to your specific
  21. needs, or improve the code and release your improvements to the
  22. public provided that the modified files carry prominent notices
  23. stating that you changed the files and the date of any change.
  24.  
  25. THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.
  26. THE ENTIRE RISK OF THE QUALITY AND PERFORMANCE OF THIS SOFTWARE
  27. IS WITH YOU. SHOULD ANY ELEMENT OF THIS SOFTWARE PROVE DEFECTIVE,
  28. YOU WILL ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR
  29. CORRECTION.
  30.  
  31. A generic singly linked list based stack. This is a last-in,
  32. first-out (LIFO) resizable data structure. Heap space is
  33. allocated and de-allocated with every push and pop operation.
  34.  
  35. Changes:
  36. ================================================================
  37. 03/02/1999: Removed the int List(const Stack<TYPE> &X) friend
  38. function used for test purposes.
  39. Changed by: Doug Gaer
  40. */
  41. // ----------------------------------------------------------- //   
  42. #ifndef __STACK_HPP
  43. #define __STACK_HPP
  44.  
  45. #include "sllist.h"
  46.  
  47. template<class TYPE>
  48. class Stack : public SLListBase
  49. {
  50. public:
  51.   Stack() { }
  52.   ~Stack();
  53.   Stack(const Stack<TYPE> &X) { Copy(X); }
  54.   void operator=(const Stack<TYPE> &X) { Copy(X); }
  55.  
  56. public:
  57.   int Push(const TYPE &X);
  58.   int Pop(TYPE &X);
  59.   int Pop();
  60.   void Rewind(unsigned Index=0);
  61.   TYPE *Top() { return IsEmpty() ? 0 : &(((SNode<TYPE> *)GetFront())->Data); }
  62.   const TYPE *Top() const { return ((Stack<TYPE> *)this)->Top(); }
  63.   TYPE *Look(unsigned Index);
  64.   const TYPE *Look(unsigned Index) const {
  65.     return ((Stack<TYPE> *)this)->Look(Index); }
  66.  
  67. protected:
  68.   virtual SNode<TYPE> *AllocNode(const TYPE &X);
  69.   virtual SNodeBase *DupNode(const SNodeBase *Node);
  70.   virtual void FreeNode(SNodeBase *Node);
  71. };
  72.  
  73. template<class TYPE>
  74. Stack<TYPE>::~Stack()
  75. {
  76.   Rewind();
  77. }
  78.  
  79. template<class TYPE>
  80. SNode<TYPE> *Stack<TYPE>::AllocNode(const TYPE &X)
  81. {
  82.   return new SNode<TYPE>(X);
  83. }
  84.  
  85. template<class TYPE>
  86. SNodeBase *Stack<TYPE>::DupNode(const SNodeBase *Node)
  87. {
  88.   return new SNode<TYPE>(((SNode<TYPE> *)Node)->Data);
  89. }
  90.  
  91. template<class TYPE>
  92. void Stack<TYPE>::FreeNode(SNodeBase *Node)
  93. {
  94.   delete (SNode<TYPE> *)Node;
  95. }
  96.  
  97. template<class TYPE>
  98. int Stack<TYPE>::Push(const TYPE &X)
  99. {
  100.   SNode<TYPE> *ptr = AllocNode(X);
  101.   if (ptr == 0) return 0; // Allocation failed
  102.   AttachToFront(ptr);
  103.   return 1;
  104. }
  105.  
  106. template<class TYPE>
  107. int Stack<TYPE>::Pop(TYPE &X)
  108. {
  109.   SNode<TYPE> *ptr = (SNode<TYPE> *)RmvFront();
  110.   if (ptr == 0) return 0; // Stack is empty
  111.   X = ptr->Data;
  112.   FreeNode(ptr);
  113.   return 1;
  114. }
  115.  
  116. template<class TYPE>
  117. int Stack<TYPE>::Pop()
  118. {
  119.   if (IsEmpty()) return 0; // Stack is empty
  120.   FreeNode(RmvFront());
  121.   return 1;
  122. }
  123.  
  124. template<class TYPE>
  125. TYPE *Stack<TYPE>::Look(unsigned Index)
  126. {
  127.   SNode<TYPE> *ptr = (SNode<TYPE> *)GetFront();
  128.   while(!IsHeader(ptr)) {
  129.     if (Index-- == 0) return &ptr->Data; // Return data in the top elememnt
  130.     ptr = ptr->GetNext();
  131.   }
  132.   return 0; // Out of range
  133. }
  134.  
  135. template<class TYPE>
  136. void Stack<TYPE>::Rewind(unsigned Index)
  137. {
  138.   if (Index == 0) Index = (unsigned)(-1); // Biggest number that can be used
  139.   SNode<TYPE> *ptr = (SNode<TYPE> *)Next;
  140.   while(!IsHeader(ptr) && Index--) {
  141.     SNode<TYPE> *NextPtr = ptr->GetNext();
  142.     FreeNode(ptr);
  143.     ptr = NextPtr;
  144.     Next = NextPtr;
  145.   }
  146. }
  147.  
  148. #endif // __STACK_HPP
  149. // ----------------------------------------------------------- // 
  150. // ------------------------------- //
  151. // --------- End of File --------- //
  152. // ------------------------------- //
  153.